home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / cmode.z / cmode
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ccccmmmmooooddddeeee((((3333GGGG))))                                                            ccccmmmmooooddddeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ccccmmmmooooddddeeee - sets color map mode as the current mode.
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ccccmmmmooooddddeeee(((())))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _n_o_n_e
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      ccccmmmmooooddddeeee instructs the system to treat color as a 1-component entity in the
  19.      currently active drawmode.  The single color component is used as an
  20.      index into a table of RGB color values called the color map.  Because
  21.      color map mode is the default value for all GL framebuffers, it can be
  22.      called in any of the framebuffer drawmodes (NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW,,,, PPPPUUUUPPPPDDDDRRRRAAAAWWWW,,,,
  23.      OOOOVVVVEEEERRRRDDDDRRRRAAAAWWWW,,,, and UUUUNNNNDDDDEEEERRRRDDDDRRRRAAAAWWWW).  To return the normal framebuffer to color map
  24.      mode, however, you must call ccccmmmmooooddddeeee while in drawmode NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  You
  25.      must call ggggccccoooonnnnffffiiiigggg for ccccmmmmooooddddeeee to take effect.
  26.  
  27.      While in color map mode, a framebuffer is configured to store a single
  28.      color index at each pixel location.  The framebuffer is displayed by
  29.      continually translating color indices into RGB triples using the
  30.      framebuffer's color map, a table of index-to-RGB mappings.  The red,
  31.      green, and blue components stored in the color map are used (after
  32.      correction for monitor non-linearity) to directly control the color guns
  33.      of the monitor.  Colors and writemasks must be specified using color
  34.      map-compatible commands such as ccccoooolllloooorrrr, ccccoooolllloooorrrrffff, and wwwwrrrriiiitttteeeemmmmaaaasssskkkk.
  35.  
  36.      Many advanced rendering features, such as texture mapping, polygon
  37.      antialiasing, and fog, are available only in RGB mode.  Color map mode
  38.      lighting, while functional, is substantially less robust than its RGB
  39.      mode counterpart.
  40.  
  41.      Since ccccmmmmooooddddeeee is the default, you do not have to call it unless the normal
  42.      framebuffer was previously set to RGB mode.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      color, drawmode, gconfig, getdisplaymode, getgdesc, multimap, onemap,
  46.      RGBmode, writemask
  47.  
  48. NNNNOOOOTTTTEEEE
  49.      Color map mode is available in all framebuffers of all hardware
  50.      configurations.  ggggeeeettttggggddddeeeesssscccc can be used to determine how many bitplanes in
  51.      each of the normal, popup, overlay, and underlay framebuffers are
  52.      available in both single and double buffered color map mode.
  53.  
  54.      This routine is available only in immediate mode.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.